Recording Macros
You can record macros in the Macro Player dialog to automate frequently used commands or processes.
While it is possible to record a macro for almost any action that applies to Dragonfly, some features may be disabled when you are recording. This is because some actions require considerable user input and are too difficult to automate.
If you want to share macros with other members of your team, you can send them your macro files. They can then add these files to their Python user or Python all users extension folders. You can also browse for and download macros in the Infinite Toolbox (see Infinite Toolbox).
How to Record a Macro
- Make sure that all the objects — image data, regions of interest, meshes, and so on — that you plan to include in your macro are readily accessible in the workspace.
- Choose Tools > Macro Player on the menu bar.
The Macro Player dialog opens.
- Click the New
button.
The Create Macro File dialog appears.
- Enter a name for your new macro in the Create Macro File dialog.
NOTE When naming or renaming a macro, you should use a unique name whenever possible. However, you should note that each macro is assigned a unique identifier (UID) and unique names are not required.
- Choose an accessibility option for your macro — Current user or All users.
- Macros for the current user are saved to the
AppData\Local\ORS\DragonflyXX\pythonUserExtensions\Macrosfolder on your computer. - Macros for all users are saved to the
ProgramData\ORS\DragonflyXX\pythonAllUsersExtensions\Macrosfolder on your computer.
- Macros for the current user are saved to the
- Do one of the following:
- Click the Create file button. You will then need to click the Record
button to begin recording. - Click the Create file and start recording button. If you select this option recording will be begin immediately.
NOTE The Record option changes to Pause as soon as you begin recording.
- Click the Create file button. You will then need to click the Record
- Perform the steps you want to record for the macro. Dragonfly will automatically capture each of the steps.
- When you have completed all the steps that you want to record, click the Stop
button.
This stops recording and saves all of the completed steps.
- Expand the About macro box and then enter additional information about your macro in the Current tab, optional.
- You can add information about the macro, such as an explanation of the input steps and guidelines for selecting required parameters, in the General documentation field.
- You can update the author and contact information, as well as the copyright and date of creation.
- You can modify the version number in the Version text box.
- Click the Save
button if you made any changes to your macro after you stopped recording.
What's Next
After you record a macro, you can play it back (see Playing Macros) or edit specific steps.
